package org.example.servicefaculty.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.example.model.manage.bean.po.Counselor;
import org.example.model.manage.bean.po.Faculty;
import org.example.model.manage.bean.po.Major;
import org.example.model.manage.bean.po.Student;
import org.example.model.manage.bean.vo.FacultyCount;
import org.example.model.manage.bean.vo.MajorCount;

import java.util.List;

/**
 * <p>
 * 学院表 Mapper 接口 - 学院只能操作自己学院内的数据
 * </p>
 *
 * @author author
 * @since 2025-08-14
 */
@Mapper
public interface FacultyMapper extends BaseMapper<Faculty> {

    // ========== 专业管理（学院内） ==========
    
    /**
     * 根据学院ID查询专业列表
     */
    List<Major> selectMajorsByFacultyId(@Param("facultyId") Integer facultyId);

    /**
     * 根据专业ID查询专业信息
     */
    Major selectMajorById(@Param("majorId") Integer majorId);

    // ========== 辅导员管理（学院内） ==========
    
    /**
     * 根据学院ID查询辅导员列表
     */
    List<Counselor> selectCounselorsByFacultyId(@Param("facultyId") Integer facultyId);

    /**
     * 根据学院名称查询辅导员列表
     */
    List<Counselor> selectCounselorsByFacultyName(@Param("facultyName") String facultyName);

    /**
     * 根据ID查询辅导员
     */
    Counselor selectCounselorById(@Param("id") Integer id);

    // ========== 学生管理（学院内） ==========
    
    /**
     * 根据专业ID查询学生列表
     */
    List<Student> selectStudentsByMajorId(@Param("majorId") Integer majorId);

    /**
     * 插入学生信息
     */
    int insertStudent(Student student);

    /**
     * 更新学生信息
     */
    int updateStudent(Student student);

    /**
     * 删除学生
     */
    int deleteStudent(@Param("id") Integer id);

    /**
     * 根据姓名和专业ID查询学生
     */
    Student selectStudentByNameAndMajorId(@Param("name") String name, @Param("majorId") Integer majorId);

    // ========== 统计功能 ==========
    
    /**
     * 查询学院统计信息
     */
    FacultyCount selectFacultyCount(@Param("facultyId") Integer facultyId);

    /**
     * 根据学院ID查询专业统计列表
     */
    List<MajorCount> selectMajorCountsByFacultyId(@Param("facultyId") Integer facultyId);
}